home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dmail11d.zip / SYSOPMAN.DOC < prev    next >
Text File  |  1992-03-22  |  83KB  |  1,525 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                               DataMail Version 1.1
  20.                                  Sysop's Manual
  21.  
  22.  
  23.                       Copyright 1991, 1992 Richard K. Naff
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                              DataMail Version 1.1
  38.                        Sysop's Manual:  Table of Contents
  39.  
  40.  
  41.      Why DataMail? . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  42.  
  43.      Legal Notices . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  44.  
  45.      BBS Specific Files  . . . . . . . . . . . . . . . . . . . . . . .    3
  46.  
  47.      System Requirements . . . . . . . . . . . . . . . . . . . . . . .    3
  48.  
  49.      What Are Those Files? . . . . . . . . . . . . . . . . . . . . . .    3
  50.  
  51.      Installation  . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  52.  
  53.      Global Limitations  . . . . . . . . . . . . . . . . . . . . . . .    5
  54.  
  55.      Security Level Limitations  . . . . . . . . . . . . . . . . . . .    6
  56.  
  57.      Monitoring  . . . . . . . . . . . . . . . . . . . . . . . . . . .    8
  58.  
  59.      DataMail Groups . . . . . . . . . . . . . . . . . . . . . . . . .    9
  60.  
  61.      About File Transfers  . . . . . . . . . . . . . . . . . . . . . .    9
  62.  
  63.      File Uploads  . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  64.  
  65.      File Overlays . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  66.  
  67.      File Downloads  . . . . . . . . . . . . . . . . . . . . . . . . .   12
  68.  
  69.      Blocking Uploads of specific Filenames  . . . . . . . . . . . . .   12
  70.  
  71.      Force-Deleting Files from Your Disk . . . . . . . . . . . . . . .   13
  72.  
  73.      DMUSRBLD: DataMail Maintenance Program  . . . . . . . . . . . . .   13
  74.  
  75.      Post-Caller Maintenance . . . . . . . . . . . . . . . . . . . . .   14
  76.  
  77.      End-of-Day Maintenance  . . . . . . . . . . . . . . . . . . . . .   15
  78.  
  79.      On-the-Fly Maintenance  . . . . . . . . . . . . . . . . . . . . .   15
  80.  
  81.      DMCHECK: Login-time Check for Pending Files . . . . . . . . . . .   16
  82.  
  83.      DMREPORT: Cross-Referenced Statistics . . . . . . . . . . . . . .   17
  84.  
  85.      DMUTIMSG: UTI Message Builder/Invocation  . . . . . . . . . . . .   17
  86.  
  87.      Local Mode from Your BBS  . . . . . . . . . . . . . . . . . . . .   19
  88.  
  89.      Local Mode from DOS . . . . . . . . . . . . . . . . . . . . . . .   19
  90.  
  91.      Sponsorship Advertising . . . . . . . . . . . . . . . . . . . . .   20
  92.  
  93.      Registration  . . . . . . . . . . . . . . . . . . . . . . . . . .   22
  94.  
  95.      Conversion to Other BBS Software  . . . . . . . . . . . . . . . .   23
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                     DataMail
  112.      Sysop's Manual               Version 1.1                        Page 1
  113.      ======================================================================
  114.  
  115.  
  116.  
  117.           Thank you for  investigating DataMail.   Hopefully, you and  your
  118.      Users will  find DataMail  to be  extremely  flexible and  supportive.
  119.      Before  getting  into  the  details  about  running  and   maintaining
  120.      DataMail, I would  like to  strongly encourage you  to first read  the
  121.      User's Guide.  Remember that as the Sysop, you are also a User of your
  122.      own  BBS.   The  User's Guide  will  give  you some  idea  as to  what
  123.      functions  DataMail  offers   and  how  it   works  from  the   User's
  124.      perspective.  In  all likelihood (unless you  configure it otherwise),
  125.      DataMail is going to be notifying you sooner or later that one of your
  126.      Users has  uploaded a file for you.   At that point,  you will need to
  127.      become  "User  savvy" anyway,  so reading  the  User's Guide  now will
  128.      certainly not  be a waste  of time.  Additionally,  some of DataMail's
  129.      configuration options might  seem a  little confusing if  you are  not
  130.      aware of their effect on the User's end of things.
  131.  
  132.  
  133.      Why DataMail?
  134.      =============
  135.  
  136.           Why indeed!   I wrote DataMail  for the benefit  of my Users.   I
  137.      also designed it in such a  manner that it would be easy to  maintain,
  138.      flexible  when  new  releases of  my  BBS  software (SpitFire)  become
  139.      available, and portable to virtually all other BBS  software packages.
  140.  
  141.           The  User's  Guide details  the  benefit of  DataMail  over other
  142.      related  software.   It also  explains why  DataMail is  likely  to be
  143.      preferable over the use of "Messages  with attached files" if your BBS
  144.      software happens to  support that  feature.  DataMail  is designed  to
  145.      handle  virtually any  condition that  a User  might dream-up  when it
  146.      comes  to sending and receiving private files, without placing a drain
  147.      on the Sysop's resources.
  148.  
  149.  
  150.      Legal Notices
  151.      =============
  152.  
  153.           The DataMail  programs, support  files,  User's Guide,  and  this
  154.      Sysop's  Manual and  its addendums  are all  copyright 1991  and 1992,
  155.      Richard K. Naff, all rights reserved.  These items may not be tampered
  156.      with  nor altered in any manner for  whatever reason.  You are granted
  157.      the  express right  to  distribute these  items, provided  you observe
  158.      these constraints:
  159.  
  160.           1)   All materials  are distributed together as  a whole, intact,
  161.                exactly as you received them.
  162.           2)   You do not charge a fee of any nature which  is directly and
  163.                specifically related  to the DataMail  distribution package.
  164.                If you normally charge  a fee for general access to your BBS
  165.                (or distribute  software on  diskettes  and charge  for  the
  166.                diskette and mailing/handling),  you are expressly permitted
  167.                the  right to  distribute DataMail.    However, you  are not
  168.                allowed  to  attach any  unique,  special  fee for  DataMail
  169.                itself.
  170.                                     DataMail
  171.      Page 2                       Version 1.1                Sysop's Manual
  172.      ======================================================================
  173.  
  174.  
  175.           DataMail is not  free.  It  is distributed  as ShareWare to  keep
  176.      costs down, which in  turn means your final price is  much lower.  You
  177.      are  allowed to  evaluate DataMail  on your  BBS for  a period  not to
  178.      exceed 60 calendar days.  From the first day you install DataMail, you
  179.      should  decide whether  or not you  wish to  make continued  use of it
  180.      within that 60 day  period.  After  60 days, you have  a 14 day  grace
  181.      period in which to pay for  DataMail.  After 74 days, if you  have not
  182.      paid for DataMail,  you are  required to permanently  cease using  it.
  183.      Please refer to  the Registration/Licensing  form at the  end of  this
  184.      document.
  185.  
  186.           DataMail  is not "sold".   DataMail remains the  sole property of
  187.      Richard  K. Naff  at  all times.   You  may  obtain a  license  to use
  188.      DataMail, but you may not  buy the software itself.  There is  no such
  189.      thing as  a site license.   Each set of  operational DataMail database
  190.      files  installed require their own license, even if they are installed
  191.      in a single  computer (Multi-node operation  is supported by  DataMail
  192.      with  one set of  operational files).   Each other  set of operational
  193.      files requires its own license (even if they are all in one computer).
  194.      Licenses  are  granted  for  the  life  of  the  Sysop,  but  are  not
  195.      transferable.
  196.  
  197.           CAUTION:  Some States regard the exchange of electronic data as a
  198.      taxable  service if  you  charge for  that exchange.   Note  that this
  199.      generally does not apply to "regular" BBS file uploads & downloads; if
  200.      you charge for  access to your  BBS, you are  usually not included  in
  201.      this tax,  if indeed it applies in your State.  However, DataMail is a
  202.      different kettle  of fish.  Its sole purpose is to exchange files, and
  203.      to  specific  individuals at  that.   If  you charge  specifically for
  204.      access to, or  use of DataMail, you will most  certainly be subject to
  205.      this tax if your State imposes it!  The  author is not responsible for
  206.      collection and payment  of any taxes  due.  You  are required to  keep
  207.      your own records  and pay your own taxes to  your State, in accordance
  208.      with  its laws.   You  are responsible  for knowing  and understanding
  209.      those laws, and for due diligence in determining what those laws are.
  210.  
  211.           WARRANTY.  DataMail is warranted  to not directly manipulate  any
  212.      of  your BBS-related files if you have  installed it correctly and are
  213.      using a  storage disk & path  which your BBS (or  other software) does
  214.      not use.  Any corruption to any of your files will either be caused by
  215.      your  UTI programs,  power outages,  TSR/Device-Drivers,  SHARE.EXE, a
  216.      corrupted DOS  Operating System, or misconfiguration.   All warranties
  217.      for  compatibility   with  your   specific  DOS-based   system  and/or
  218.      suitability of purpose are  expressly denied.  Warranties for  loss of
  219.      information,  security  restriction malfunctions,  disk-access errors,
  220.      file transfers, and other  aspects beyond the control of  DataMail and
  221.      its author are likewise expressly denied.  The author's sole liability
  222.      shall extend to a refund of all monies paid for DataMail licenses, and
  223.      shall not extend  to loss of profits,  punitive damages, consequential
  224.      expenses, nor loss  of any  information on any  computer system  which
  225.      accesses DataMail  (directly or indirectly),  and the  license to  use
  226.      DataMail must be immediately surrendered upon refund of said licensing
  227.      fees.
  228.                                     DataMail
  229.      Sysop's Manual               Version 1.1                        Page 3
  230.      ======================================================================
  231.  
  232.  
  233.      BBS Specific Files
  234.      ==================
  235.  
  236.           DataMail is designed  to be easily and  speedily portable between
  237.      BBS software.  For  example, if you are  currently using WildCat!  and
  238.      decide  to switch to SpitFire, your existing DataMail databases may be
  239.      converted, intact, to your  new BBS software with only  minor changes.
  240.      Specifically, you will be required to rename one program, and purchase
  241.      a  UTI  (Universal Text  Interface)  program  for your  new  software.
  242.      Beyond that, no  changes to, or on  behalf of, DataMail  are required.
  243.      Please refer to the addendums for your specific target BBS software.
  244.  
  245.  
  246.      System Requirements
  247.      ===================
  248.  
  249.           You need the following to run DataMail:
  250.  
  251.           1)   IBM BIOS Compatible Computer
  252.           2)   DOS Operating System, 3.1 or higher
  253.           3)   SHARE.EXE loaded in your CONFIG.SYS
  254.           4)   ANSI.SYS (or compatible) loaded in your CONFIG.SYS
  255.           5)   FILES=20 (or higher) specified in your CONFIG.SYS
  256.           6)   BUFFERS=20 (or higher) specified in your CONFIG.SYS
  257.           7)   150K Free Memory after your BBS software is loaded
  258.                (More if possible to allow longer Receiver Lists)
  259.           8)   BBS Software which supports the DOOR.SYS file standard
  260.  
  261.  
  262.      What Are Those Files?
  263.      =====================
  264.  
  265.           DataMail uses several files to get  its job done.  When you first
  266.      install  DataMail, you will  not see all  of these files.   That's OK.
  267.      The database files are created only when accessed for  the first time,
  268.      so until  all parts  of the DataMail  door are  exercised, some  files
  269.      won't show-up on your disk:
  270.  
  271.           DATAMAIL.EXE        The DataMail door itself
  272.           DMUTIMSG.EXE        The UTI Message  Formatter/Invoker. Run  this
  273.                               when there is a DMESSAGE.x file present.
  274.           DMCONFIG.EXE        The Sysop's Configuration program
  275.           DMUSRBLD.EXE*       The  User's  Database Builder  & Maintenance.
  276.                               This   file  exists   only  after   you  have
  277.                               extracted the appropriate  file from the BBS-
  278.                               Specific  distribution  file.   This  program
  279.                               must exist on your disk by this name.
  280.           DMREPORT.EXE        The  Database Reporting  Program.   Let's you
  281.                               see   everything   about  your   Users  using
  282.                               Datamail  in various  aspects,  to  help  you
  283.                               control your Users' use/abuse of DataMail.
  284.                                     DataMail
  285.      Page 4                       Version 1.1                Sysop's Manual
  286.      ======================================================================
  287.  
  288.  
  289.           DMCHECK.EXE         For BBSes which generate  a DOOR.SYS at logon
  290.                               time, you can use DMCHECK when the User  logs
  291.                               onto your BBS to see if one or more files are
  292.                               waiting  for him/her.   DMCHECK exits  with a
  293.                               return-code of 1 if any files are found.  You
  294.                               can check ERRORLEVEL == 1 in your logon batch
  295.                               file, and if true, run DATAMAIL immediately
  296.           DMXFERS.TXT         Text Display for available protocols.
  297.           DM01CDB.DBD         The  Database  Definition  File.   This  file
  298.                               contains  the  controlling information  about
  299.                               how all other database files are laid out.
  300.           DM010000.KEY/.DAT   The User's Database
  301.           DM010001.KEY/.DAT   The File/Uploader's Database
  302.           DM010002.KEY/.DAT   The Receiver's Database
  303.           DM010003.KEY/.DAT   The Group/Host's Database
  304.           DM010004.KEY/.DAT   The Member's Database
  305.           DM010005.KEY/.DAT   The Sysop's Configuration Database
  306.           DM010006.KEY/.DAT   The Sysop's Security Levels Database
  307.           DMLOG.x             The Audit File for node "x"
  308.           DMESSAGE.x          The UTI Message base file for node "x"
  309.           DMEXIT?.x           One of several files, for node "x" to show
  310.                               how the DataMail  door was exited.   You  can
  311.                               interrogate  the presence  of these  files to
  312.                               know  if the  User  exited normally,  dropped
  313.                               carrier, etc.
  314.  
  315.           There are additional files,  such as the batch files  required to
  316.      perform file transfers.   These are all under the  Sysop's control, so
  317.      their names are not shown here.
  318.  
  319.  
  320.  
  321.      Installation
  322.      ============
  323.  
  324.           Installation  is dependent upon the  BBS software you  use.  They
  325.      are all pretty much the same on the surface, but there are a few nitty
  326.      gritty  details that are different for each  BBS.  Please refer to the
  327.      proper addendum for your BBS software.
  328.  
  329.           Currently, only the  following BBSes are  supported (if yours  is
  330.      not  listed, please see the  Registration Section of  this manual; you
  331.      could receive a free license for DataMail if you are willing to assist
  332.      me  in  getting the  proper  interface programs  written  and tested).
  333.      Please print/review the documentation for your BBS software:
  334.  
  335.  
  336.                        BBS Software            Addendum
  337.                     --------------------     ------------
  338.                        PC Board 14.5a         PCB145.TXT
  339.                      Remote Access 1.1x        RA11.TXT
  340.                         SpitFire 3.x           SF31.TXT
  341.                         WildCat! 3.0x          WC30.TXT
  342.                                     DataMail
  343.      Sysop's Manual               Version 1.1                        Page 5
  344.      ======================================================================
  345.  
  346.  
  347.           In all cases, installation involves the following steps:
  348.  
  349.           -    Define the subdirectory where DataMail files will be stored,
  350.                and  the  subdirectory where  your  Users'  Uploads will  be
  351.                stored (and from where other Users will download)
  352.           -    Extract the proper DMUSRBLD.EXE file for your Software
  353.           -    Configure DataMail to read your BBS Master File
  354.           -    Build your initial DataMail User Database
  355.           -    Configure DataMail to point to your chosen directories
  356.           -    Configure DataMail to point to your UTI programs
  357.           -    Configure DataMail for the number of file transfer protocols
  358.                you wish to use (up  to 5), and the path and filename of the
  359.                batch files which accomplish the file transfers
  360.           -    Establish your file transfer batch files
  361.           -    Provide a text display for each file transfer
  362.           -    "Define" the DataMail door to your BBS
  363.  
  364.               +-------------------------------------------------+
  365.               | PLEASE PERFORM YOUR CONFIGURATION AT THIS TIME! |
  366.               +-------------------------------------------------+
  367.  
  368.           Go ahead and get it out  of the way, so you may perform  Security
  369.      Level set-ups and other  limiting factors without having to  deal with
  370.      any  configuration  problems  or  questions.    I  recommend using  my
  371.      defaults for  the time being; once you see how DataMail is supposed to
  372.      be configured, you can always come back later and change filenames and
  373.      paths, etc.
  374.  
  375.  
  376.  
  377.      Global Limitations
  378.      ==================
  379.  
  380.           There  are two items you  can configure into  DataMail which will
  381.      act  as "fail-safes" to prevent total abuse  of your disk space.  Each
  382.      of  these is accessible in  DMCONFIG when you  select Configure Global
  383.      Parameters.
  384.  
  385.           MINIMUM  REQUIRED   DISK  SPACE.    No  matter  what,  under  any
  386.           circumstances,  in  any phase  of the  moon,  even if  this month
  387.           doesn't  have a "R" in it, this  value will guarantee that no one
  388.           will upload a file which will  cause your free disk space to fall
  389.           below  this level.  If you have  a 100mb disk, and it already has
  390.           50mb of data  on it, you  might try setting  this value to  20mb.
  391.           This will mean  that, as long as nothing else  adds files to your
  392.           disk, DataMail  will allow 30mb  of files to  be uploaded  and no
  393.           more.  Once the available free disk space reaches 20mb or  lower,
  394.           DataMail stops  accepting  uploads.    No  exceptions  (not  even
  395.           locally).    Whatever  value  you  specify  here  is  sacrosanct.
  396.           DataMail will never violate this limit.
  397.                                     DataMail
  398.      Page 6                       Version 1.1                Sysop's Manual
  399.      ======================================================================
  400.  
  401.  
  402.           MAXIMUM  RETENTION PERIOD.  You  will notice in  the next section
  403.           for Security Levels that DataMail will let you specify how long a
  404.           file may be kept  on your disk  while waiting for its  designated
  405.           receiver(s) to download it.   We'll cover this in more  detail in
  406.           that section, but you  should be aware that this  value OVERRIDES
  407.           anything and  everything you specify for  the individual security
  408.           levels.  If you set this value  to 90, for example, then no files
  409.           will be kept  over 90 days.   Even if  you have a Security  Level
  410.           which  stipulates that files may be kept for 120 days, this value
  411.           overrides that number, and 90 days  is the time period that  will
  412.           be used.  This value can be used as a fail-safe mechanism just in
  413.           case  you think  you  might  make  a  mistake  while  configuring
  414.           Security Levels.  However,  it is primarily intended as  a short-
  415.           cut to temporary changes  in retention periods.  If  you suddenly
  416.           find that you need extra  disk space for something else,  you can
  417.           set this value  to 5.  This will  mean that any new  uploads will
  418.           only be kept for  5 days, then they  will be deleted.  When  your
  419.           disk space becomes free again, raise  this value back to 90.  The
  420.           intent is to save you keystrokes by not having to change all your
  421.           Security  Levels to 5 days, and then  go back and change them all
  422.           to their original  values.  Just change  this one value,  and you
  423.           are in business.
  424.  
  425.  
  426.  
  427.      Security Level Limitations
  428.      ==========================
  429.  
  430.           DataMail uses its own security levels.  These are closely tied to
  431.      the  security levels  of your  BBS, but  are not  necessarily directly
  432.      related unless you set them up that way.  As distributed, DataMail has
  433.      only  one security level: 0.  All  users of DataMail will get security
  434.      level 0 unless you add more levels.
  435.  
  436.           The  way it  works  is that  DataMail  looks  at the  User's  BBS
  437.      security  level, and then finds  its own highest  security level which
  438.      does not exceed the security  level of the User.  For  example, assume
  439.      your BBS has security levels  10, 100, 200, 500, and 900.  Assume also
  440.      that you  have configured DataMail  to acknowledge security  levels 0,
  441.      100, and 500.  Under  these conditions, Users with BBS security  level
  442.      10 will get DataMail security 0,   BBS sec-lvls 100 & 200 get DataMail
  443.      Sec-lvl 100, and BBS sec-lvls 500 & 900 get DataMail sec-lvl 500.
  444.  
  445.           DataMail security  level 0 is kind  of special.  Since  all Users
  446.      (no matter what  their BBS security  level) will  have a BBS  security
  447.      level greater  than or equal  to 0, DataMail  is guaranteed  to assign
  448.      them security level 0 if you have not configured any  others.  Because
  449.      of this, DataMail  security level 0 must ALWAYS be  defined!  You will
  450.      find that  you can change  the aspects  of security level  0, but  YOU
  451.      CANNOT DELETE IT!  You will find that all other security levels can be
  452.      added, changed, and deleted as you like, but security level 0 can only
  453.      be changed.
  454.                                     DataMail
  455.      Sysop's Manual               Version 1.1                        Page 7
  456.      ======================================================================
  457.  
  458.  
  459.           When you run DMCONFIG, select  Configure Security Levels and  you
  460.      will see a short menu allowing you to Add, Change,  or Delete security
  461.      levels.  Their individual functions should be self-explanatory  (i.e.,
  462.      "Add"  will set-up  a new security  level, etc.).   While working with
  463.      these  functions,  keep in  mind the  Global Limitation  pertaining to
  464.      retention period.   It doesn't  make any  difference what you  set the
  465.      retention  periods to for  the security levels if  the Global value is
  466.      the lesser; DataMail takes the shortest time period between the Global
  467.      and security level retention periods.
  468.  
  469.           Each  aspect of security level values is explained in detail when
  470.      you select Add or Change, but here they are in a nutshell:
  471.  
  472.           RECEIVER'S SECURITY LEVEL.   This value refers to  the receiver's
  473.           BBS security level.  The designated receiver must have a security
  474.           level  equal to  or  greater than  the  value you  specify  here,
  475.           otherwise DataMail will not  let the current User upload  to that
  476.           receiver.   For example, let's  say your new,  unverified callers
  477.           are assigned  security level 10 on your  BBS, and you are setting
  478.           up DataMail security level 10 at the  moment.  If you do not want
  479.           these new, unverified callers uploading to other new,  unverified
  480.           callers,  set this value to  at least 11.   In that  case, when a
  481.           User  of  BBS/DataMail security  level 10  tries  to upload  to a
  482.           receiver of BBS security  level 10, DataMail will tell  them they
  483.           are not allowed to do that and will ask them for another name (or
  484.           quit).  Unless you have oodles of disk space and don't care about
  485.           who calls your BBS, I strongly recommend this for new, unverified
  486.           callers.   Otherwise, you are likely  to find that all  that free
  487.           disk space has suddenly disappeared!
  488.  
  489.           NUMBER OF OUTSTANDING  FILES.   This value limits  the number  of
  490.           files a User can  have sitting on your disk at any  one moment in
  491.           time.  More precisely, it limits NEW  files.  If you let John Doe
  492.           upload 5 files a few days ago,  then change his DataMail security
  493.           level entry  to allow only  3 files, John cannot  upload any more
  494.           NEW files.  He can, however,  OVERLAY any of his existing 5 files
  495.           as long as they are on your disk.
  496.  
  497.           RETENTION PERIOD IN DAYS.  This  value is "attached" to a file at
  498.           time of upload or overlay.   Changing this value AFTER a  file is
  499.           already on your disk does not change the retention period of that
  500.           file (retention  periods are assigned after  a successful upload,
  501.           and  are  not reassigned  at  any  other point).    When you  run
  502.           DMUSRBLD for your  daily maintenance, this  date is checked  with
  503.           today's  date.  If today  is "greater" than  the retention period
  504.           date, the file is automatically purged from your disk.
  505.                                     DataMail
  506.      Page 8                       Version 1.1                Sysop's Manual
  507.      ======================================================================
  508.  
  509.  
  510.           MAXIMUM FILE  SIZE.  This file limits the size of any single file
  511.           uploaded.  It does NOT represent the "total allowed  bytes of all
  512.           files uploaded  by a User".  It affects only  one file at a time.
  513.           If you  have a security  level for  which you do  not want  Users
  514.           uploading at all, I recommend setting this value to  0.  If so, a
  515.           user of this DataMail security level  will not be able to upload.
  516.           They  WILL be able  to download  any files  that someone  sent to
  517.           them, but they cannot upload.
  518.  
  519.           That about wraps  it up  for Configuring DataMail.   Your  Global
  520.      configuration  values  should stay  fairly  static  unless you  rename
  521.      directories (which I don't recommend).  If  there's any tweaking to be
  522.      done in terms of reaching a happy compromise between your Users' needs
  523.      and your disk space, you will find that the Security Level  Parameters
  524.      are  normally the  place to  turn.   The  above limitations  should be
  525.      flexible and  rich enough to  allow you  to limit your  Users' use  of
  526.      DataMail to the  point that they  get what they  need, but you  aren't
  527.      subjected to abuse of your disk space.
  528.  
  529.  
  530.      Monitoring
  531.      ==========
  532.  
  533.           Congratulations!  DataMail is now fully operational on  your BBS!
  534.      Things you might want to do in the  first week or two of use, or on  a
  535.      regular monthly basis:
  536.  
  537.           1)   Monitor your uploads.  Check to see how many files people of
  538.                each  security level  are uploading,  and each  file's size.
  539.                Compare this  with  your  available  disk  space,  and  make
  540.                adjustments in your Security Level Configurations.
  541.  
  542.           2)   If you operate  a multi-node  system, iron the  bugs out  of
  543.                your set up and  your batch files for file transfers.   When
  544.                your first node is running smoothly, set up a DM2.BAT, etc.,
  545.                file  to handle other nodes, and define the DataMail door to
  546.                your BBS  software so that other nodes can run DataMail.  No
  547.                changes  (other  than  DM2.BAT,  DM3.BAT,  etc.)  should  be
  548.                required  for DMCONFIG;  everything should  remain identical
  549.                across  all nodes.   The only changes should  be to your BBS
  550.                software (defining a new door to your other nodes).
  551.  
  552.           3)   Monitor your new callers!  If you don't care that new people
  553.                will  be calling just to use DataMail to exchange files with
  554.                their buddies across town, then skip this.   But if you have
  555.                left  DataMail wide-open  to unlimited  use, you  might find
  556.                your disk space rapidly dwindling!  If so, go back and place
  557.                some tighter restrictions on who can upload to whom, and how
  558.                much at any one  time.  Cut back  on new callers'  abilities
  559.                until  they  have been  "verified".    Reduce the  retention
  560.                period for files uploaded by new callers.
  561.                                     DataMail
  562.      Sysop's Manual               Version 1.1                        Page 9
  563.      ======================================================================
  564.  
  565.  
  566.      DataMail Groups
  567.      ===============
  568.  
  569.           DataMail Groups are explained in  the User's Guide.  You  are not
  570.      required  to support these, but it will  provide your Users with added
  571.      benefits  if you do.   In other cases, you (as  both Sysop and User of
  572.      your BBS) may wish to make a certain set  of files available to only a
  573.      select  few individuals.   In this  case, it's  a whole  lot easier to
  574.      define  a DataMail Group with a list of "permanent" names and "upload"
  575.      your  file(s)  to that  Group.    Without Groups,  you  would have  to
  576.      manually  type every  receiver's name  each time  you had  a file  you
  577.      wanted to send to them.
  578.  
  579.           DMCONFIG  lets you Add &  Delete DataMail Groups.   Only DMCONFIG
  580.      can be used  to Add and Delete Groups; the  DataMail door program will
  581.      let you or your designated Group Host Add & Delete Members of a Group.
  582.  
  583.           DMCONFIG  also lets you  establish a User  of your  choice as the
  584.      Host  of that Group.  You, as Sysop, are always a Host of every Group,
  585.      in addition  to any User you set-up as Host.   If the Group you define
  586.      is for your own needs (private files from you to your Users), you will
  587.      probably NOT want  to establish a Host for the Group.  In other cases,
  588.      where you have a few Users who  happen to use your BBS as their  "Home
  589.      Base" for communicating with each other, you might want  to define one
  590.      of those Users as the Group's Host.  The only added function a Host of
  591.      a  Group has is that he/she  is able to add or  delete Members of that
  592.      Group.  Other than that, a Host has no special privileges in DataMail.
  593.  
  594.           A HOST IS NOT A MEMBER OF A GROUP BY DEFAULT.  If the Host wishes
  595.      to send or receive files via the Group, he/she MUST add their own name
  596.      as a Group member.  Users cannot upload  to a Group if they are not  a
  597.      member of that Group.  Users who are not  a member of a Group will not
  598.      receive  a copy of a file uploaded to that Group.  In a nutshell, file
  599.      uploads to Group  members can only occur  if all persons involved  are
  600.      members  of the Group.   Hosts (you as  Sysop, and any  other User you
  601.      define as Host) are not automatically members of a Group.
  602.  
  603.  
  604.      About File Transfers
  605.      ====================
  606.  
  607.           DataMail  uses batch files for  file transfers.   You are free to
  608.      use  whatever protocol you wish in those batch files; DataMail doesn't
  609.      care.   Based upon your Global Configuration and the protocol selected
  610.      by the User,  DataMail will spawn a batch file  and pass the following
  611.      (all values  other than the  first 2  are acquired  from the  DOOR.SYS
  612.      file):
  613.  
  614.           -    An "R" or an  "S", which denotes whether  a Receive or  Send
  615.                should be accomplished.  Simply "goto" a label in your batch
  616.                file which handles uploads or downloads, respectively.
  617.                                     DataMail
  618.      Page 10                      Version 1.1                Sysop's Manual
  619.      ======================================================================
  620.  
  621.  
  622.           -    The full path  and filename of  the file  to be uploaded  or
  623.                downloaded.  This consists  of the path you defined  in your
  624.                Global Configuration where files are to be stored,  followed
  625.                by  a "\",  followed by  the name  of the  file the  User is
  626.                attempting to transfer.   For UPLOADS only, the  filename is
  627.                ALWAYS DATAMAIL.x, where "x"  is your Node number.   After a
  628.                successful upload, this file is renamed to the name the User
  629.                asked for.  Downloads ALWAYS represent the exact filename to
  630.                download.
  631.  
  632.           -    The  Communications port  number (e.g., 1  or 2,  etc.) with
  633.                which the current Node is associated.
  634.  
  635.           -    The  DTE/DCE bps rate.  This is  the bps speed at which your
  636.                computer  is communicating with your modem.   For Sysops who
  637.                lock  their DTE/DCE speed to a constant value (such as 19200
  638.                or  38400), you should use  this parameter for your protocol
  639.                program.  If  necessary, tell your protocol  program you are
  640.                using Hardware data-flow control (RTS/CTS).
  641.  
  642.           -    The Modem/Modem rate.   This is the  bps rate at  which your
  643.                modem  and the  caller's modem  are actually  communicating,
  644.                regardless of whether  you or your  User have their  DTE/DCE
  645.                speeds locked.  If you do not lock your  DTE/DCE speed, then
  646.                more  than likely your modem (and your BBS software) adjusts
  647.                to  this speed.   In that  event, this is  the parameter you
  648.                should pass  to your protocol  program.  If  necessary, tell
  649.                your  protocol  program  you  are  using Software  data-flow
  650.                control (Ctrl-S/Ctrl-Q, otherwise known as XON/XOFF).
  651.  
  652.           -    The  UART base address of the communications port in use, in
  653.                HEXADECIMAL   notation.     If   you   use  a   non-standard
  654.                communications  port (i.e., you cannot simply  get by with a
  655.                plain COM1 or COM2 device name), this value should be passed
  656.                on to your  protocol program  IF IT REQUIRES  THE UART  BASE
  657.                ADDRESS IN HEXADECIMAL FORMAT.
  658.  
  659.           -    The  UART base address of the communications port in use, in
  660.                DECIMAL notation.   This is  just like the  above parameter,
  661.                except  it is  in  decimal notation  (base  10).   Use  this
  662.                parameter IF YOUR  PROTOCOL PROGRAM REQUIRES  THE UART  BASE
  663.                ADDRESS IN DECIMAL FORMAT.
  664.  
  665.           -    The IRQ number to be used  in combination with either of the
  666.                above  to parameters.   If  you supply  either of  the above
  667.                parameters  to your  protocol program,  more than  likely it
  668.                will also require the IRQ number.  In that event, pass  this
  669.                parameter to your protocol program.
  670.                                     DataMail
  671.      Sysop's Manual               Version 1.1                       Page 11
  672.      ======================================================================
  673.  
  674.  
  675.      File Uploads
  676.      ============
  677.  
  678.           During  a file  upload  (uploading  a  NEW  file  to  1  or  more
  679.      receivers), the following events occur:
  680.  
  681.           -    Before the batch file is spawned, file DATAMAIL.x (where "x"
  682.                is the current Node number) is deleted if it exists.
  683.  
  684.           -    The batch file  is spawned  to handle uploads.   You  should
  685.                check  the return code from your protocol program!  If there
  686.                was an error, you should DEL %2  (or ERASE %2, whichever you
  687.                like best).  When DataMail regains control, it will check to
  688.                see  if DATAMAIL.x exists.  If it does, DataMail assumes the
  689.                file was uploaded successfully.
  690.  
  691.           -    If DATAMAIL.x exists in your DataMail Files directory, it is
  692.                renamed to whatever the User wants it to be called.
  693.  
  694.           -    DataMail then checks  the size of  the newly received  file.
  695.                If  it   is  larger  than   that  allowed  (based   on  your
  696.                configuration  and  free  disk  space),  it  is  immediately
  697.                deleted.
  698.  
  699.           -    Each person in  the receiver list for this  file is issued a
  700.                message telling  them that a new file is waiting for them to
  701.                download.
  702.  
  703.  
  704.      File Overlays (Uploads of Existing Filenames)
  705.      =============================================
  706.  
  707.           During an Overlay (re-uploading a file by the same name, from the
  708.      same User who uploaded the original file  by that name), the following
  709.      events occur:
  710.  
  711.           -    Before the batch file is spawned, file DATAMAIL.x (where "x"
  712.                is the current Node number) is deleted if it exists.
  713.  
  714.           -    The batch file  is spawned  to handle uploads.   You  should
  715.                check  the return code from your protocol program!  If there
  716.                was  an error, you should DEL %2 (or ERASE %2, whichever you
  717.                like best).  When DataMail regains control, it will check to
  718.                see  if DATAMAIL.x exists.  If it does, DataMail assumes the
  719.                file was uploaded successfully.
  720.  
  721.           -    If DATAMAIL.x  exists in your DataMail  Files directory, the
  722.                original file is deleted,  and DATAMAIL.x is renamed to  the
  723.                old, original filename.
  724.  
  725.           -    Anyone  who was ADDED  to the receiver list  of this file is
  726.                issued a message telling them that a new file is waiting for
  727.                them.
  728.                                     DataMail
  729.      Page 12                      Version 1.1                Sysop's Manual
  730.      ======================================================================
  731.  
  732.  
  733.           -    Anyone  who was left "intact"  in the receiver  list of this
  734.                file is issued a message telling them that the original file
  735.                was overlaid, and a new copy is available.
  736.  
  737.           -    Anyone who was REMOVED  from the receiver list of  this file
  738.                is  issued a message telling them  that the Uploader deleted
  739.                the  file, and  it  is  no  longer  available  for  them  to
  740.                download.
  741.  
  742.  
  743.      File Downloads
  744.      ==============
  745.  
  746.           After a file is successfully download:
  747.  
  748.           -    DataMail sends a message to the Uploader, informing  him/her
  749.                that the file was received properly.
  750.  
  751.           -    DataMail removes the Current User from the  receiver list of
  752.                this file.
  753.  
  754.           -    DataMail  then checks the receiver  list for this  file.  If
  755.                there  are not  any  additional receivers,  DataMail removes
  756.                this  file from  its database,  and physically  deletes this
  757.                file from your disk.
  758.  
  759.           -    DataMail  then checks  to see  if there  are any  more files
  760.                waiting to be downloaded by the Current User.
  761.  
  762.  
  763.      Blocking Uploads of specific Filenames
  764.      ======================================
  765.  
  766.           DataMail checks for duplicate  filenames in two ways.   First, it
  767.      checks its own database for the  Current User to see if that User  has
  768.      already uploaded a  file by the specified name.   Next, it checks your
  769.      DataMail File directory to see if a file by that name exists.
  770.  
  771.           In  the  latter case,  DataMail will  tell  the User  that he/she
  772.      cannot upload a file by  that name, because one already exists.   This
  773.      feature is  provided for those Sysops who  do not want Users uploading
  774.      files by the names  of COMMAND.COM, CONFIG.SYS, etc.   To prevent such
  775.      filenames from being uploaded,  all you have to do is define a file by
  776.      the target name in your DataMail Files directory.  It does not have to
  777.      be  the actual  file itself  (i.e., the  CONFIG.SYS file  could simply
  778.      contain "ABC"), but it must be of a length greater than 0.
  779.                                     DataMail
  780.      Sysop's Manual               Version 1.1                       Page 13
  781.      ======================================================================
  782.  
  783.  
  784.      Force-Deleting Files from Your Disk
  785.      ===================================
  786.  
  787.           If there is a file on your disk that you want to get rid of right
  788.      NOW(!), just delete it.  DataMail can gracefully handle this situation
  789.      (i.e., it thinks the file should be there, but it really isn't).
  790.  
  791.           Note  that it  would be  best to  run DMUSRBLD  immediately after
  792.      deleting files in this manner; doing so will inform the Receivers that
  793.      the file  was deleted, and DataMail will have a chance to clean-up its
  794.      own database to bring  it into synchronization with the  "real world".
  795.      Please see the On-The-Fly Maintenance section for more details.
  796.  
  797.  
  798.      DMUSRBLD: DataMail Maintenance Program
  799.      ======================================
  800.  
  801.           DMUSRBLD  is customized for each  BBS software package.   This is
  802.      the program you extracted during installation.  DMUSRBLD  accomplishes
  803.      the following functions:
  804.  
  805.           -    If DM010000.KEY/.DAT  do not  exist, DMUSRBLD  creates these
  806.                files.  These files contain information about your BBS Users
  807.                (their  Name, Security Level, etc.).  This is referred to as
  808.                "Create" or  "Rebuild"  mode,  and  can  take  a  long  time
  809.                depending upon your CPU and disk speed.
  810.  
  811.           -    If DM010000.KEY/.DAT already exist, DataMail takes  the date
  812.                of last update to this file, then scans your BBS Master File
  813.                for any Users who have a "last called" date greater  than or
  814.                equal to the  database's last  update date.   For each  such
  815.                User   found,  DataMail  retrieves  their  record  from  its
  816.                database and compares  the information it  knows about  with
  817.                your  BBS  Master File.   If  anything  about that  User has
  818.                changed, his/her  information  is updated  in  the  DataMail
  819.                databases.   This is referred  to a "Refresh"  mode and only
  820.                requires a few seconds to accomplish.
  821.  
  822.           -    Each file in the DataMail databases is checked.  If the file
  823.                does not  physically exist  on your  disk (you  deleted it),
  824.                DataMail  sends  a message  to  all  remaining receivers  to
  825.                inform  them that  the file  is no  longer available.   Each
  826.                Receiver is checked  to make  sure he/she is  still a  valid
  827.                User of  your BBS.  If  not, their name is  removed from the
  828.                receiver's list (and the file physically deleted if that was
  829.                the last receiver).   Finally, each file is checked  for its
  830.                expiration date.   If  "today"  is greater  than the  file's
  831.                expiration date,  the file  is  physically deleted  and  all
  832.                pending receivers are sent a message informing them of that.
  833.  
  834.           -    Each  Group is checked to  make sure that  Hosts and Members
  835.                are still valid  Users of your  BBS.  Those that  aren't are
  836.                removed as Host and/or Member as appropriate.
  837.                                     DataMail
  838.      Page 14                      Version 1.1                Sysop's Manual
  839.      ======================================================================
  840.  
  841.  
  842.           When DMUSRBLD runs,  you should pass it  the Node number you  are
  843.      running it from.  In other words,  if you run DMUSRBLD from Node 1  of
  844.      your BBS, you should  run it as "DMUSRBLD 1".  The  reason for this is
  845.      so that any messages created for Uploaders and/or Receivers are placed
  846.      in a  file called  DMESSAGE.x,  where "x"  is your  Node  number.   If
  847.      DMESSAGE.x already  exists, any new messages  are ADDED to it,  so the
  848.      next  time  you  run DMUTIMSG,  all  messages  created  by either  the
  849.      DataMail  door itself, or DMUSRBLD, are imported into your BBS message
  850.      bases.   Note that it is  perfectly acceptable to run  DMUSRBLD with a
  851.      non-existent Node number (such as 0).  In  fact, if you do not provide
  852.      a Node number to DMUSRBLD, this  is the "Node" assumed, and DMESSAGE.0
  853.      will be created if necessary.   You can still run DMUTIMSG and tell it
  854.      to use DMESSAGE.0 without any problems.
  855.  
  856.           The  main reason  for using a  legitimate Node number  is to make
  857.      sure your  have an  event somewhere  that will  guarantee any and  all
  858.      DMESSAGE.x files are processed by DMUTIMSG.  Also, if you run a multi-
  859.      node system, you should not be placing messages into DMESSAGE.2 if you
  860.      are not running  under that node  at the current  time; if there  is a
  861.      user logged onto Node  2 and running DataMail right  now, the messages
  862.      created by DMUSRBLD might "step on"  the messages created by the  User
  863.      of the DataMail door.
  864.  
  865.  
  866.      Post-Caller Maintenance
  867.      =======================
  868.  
  869.           As a personal preference,  I run DMUSRBLD after each  caller logs
  870.      off.   This has  the effect of  adding a  new caller  to the  DataMail
  871.      databases  immediately.   It  also has  the  effect of  upgrading  the
  872.      "known" BBS  security level of a caller if he/she did something on the
  873.      BBS  just now to increase or decrease  his/her security level.  If you
  874.      wish to do  this also, make sure  you use the correct  Node number (if
  875.      you run a multi-node BBS).   For example, when a User logs off of Node
  876.      number 1, your logoff batch file  should say "DMUSRBLD 1".  If it  was
  877.      Node number  2 that  the User  logged off of,  your logoff  batch file
  878.      should day "DMUSRBLD 2", etc.
  879.  
  880.           Note that running DMUSRBLD after each caller logs off is simply a
  881.      matter of  preference for  the Sysop.   Whatever  information DataMail
  882.      received  the last time you ran DMUSRBLD  will still be in effect, and
  883.      since  it is  likely to  change  very little  in a  single day,  there
  884.      shouldn't be any critical information missing.
  885.                                     DataMail
  886.      Sysop's Manual               Version 1.1                       Page 15
  887.      ======================================================================
  888.  
  889.  
  890.      End-of-Day Maintenance
  891.      ======================
  892.  
  893.           At midnight (or  close thereafter), you should  run DMUSRBLD from
  894.      at least one of your  BBS Nodes (if you only have one,  that's the guy
  895.      you want).   Your midnight batch  file should say "DMUSRBLD  x", where
  896.      "x" is the node  number you are running from.   You should follow this
  897.      with a:
  898.  
  899.           IF EXIST DMESSAGE.x DMUTIMSG DMESSAGE.x y z
  900.  
  901.           The above checks for any messages that DMUSRBLD created, and runs
  902.      the  DMUTIMSG program to import  those messages into  your BBS message
  903.      base.
  904.  
  905.           Running  DMUSRBLD at midnight  is highly recommended.   You don't
  906.      have to, but since  DMUSRBLD deletes files (for various  reasons), you
  907.      won't be "up to date" in  terms of expired files or invalid receivers.
  908.      Running DMUTIMSG is not  as critical, and you can skip it  if you have
  909.      no interest in importing any messages that DMUSRBLD may have created.
  910.  
  911.  
  912.      On-the-Fly Maintenance
  913.      ======================
  914.  
  915.           While  getting your  DataMail Users  Database (DM010000.KEY/.DAT)
  916.      created was  accomplished at installation time,  and "refreshing" that
  917.      database can  be done after each  caller logs off (or  at midnight, if
  918.      you  prefer),  there   are  reasons  why   you  should   force-rebuild
  919.      DM010000.KEY/.DAT.  If you perform any of the following maintenance to
  920.      your BBS  Master File, you should  (as soon as possible)  take all BBS
  921.      Nodes off-line, delete DM010000.KEY/.DAT, and run DMUSRBLD:
  922.  
  923.           -    Manually alter a User's Security Level/Lock-out Flag/Deleted
  924.                Flag, etc., WITHOUT  changing their Last-Call  Date (if  the
  925.                Last-Call Date was prior to "today")
  926.  
  927.           -    Restore from a back-up copy
  928.  
  929.           -    "Pack" or physically remove logically deleted Users
  930.  
  931.           In  some cases,  DMUSRBLD is  able to detect  that you  have made
  932.      "serious"   changes  to  your   BBS  Master  File,   and  will  delete
  933.      DM010000.KEY/.DAT  and  rebuild it  automatically.    In other  cases,
  934.      changes to your BBS  Master file are difficult to detect  in "Refresh"
  935.      mode,  and DMUSRBLD  might  not know  that  it is  dealing with  major
  936.      changes.   The "Refresh" mode is intentionally  "unintelligent" in the
  937.      interest  of making  it run as  fast as possible,  applying only minor
  938.      changes (like  a new user,  or a  user who has  been locked-out  while
  939.      online or  had their security level  changed).  To make  sure DMUSRBLD
  940.      establishes DM010000.KEY/.DAT  which represents the  "real" BBS Master
  941.      File, you should perform  the above maintenance whenever you  make any
  942.      of the above changes to your BBS Master File.
  943.                                     DataMail
  944.      Page 16                      Version 1.1                Sysop's Manual
  945.      ======================================================================
  946.  
  947.  
  948.           Generally, any of the above modifications should be made when all
  949.      BBS Nodes are off-line, so it is  a good idea to go ahead and  perform
  950.      this DataMail maintenance at the same time.
  951.  
  952.  
  953.      DMCHECK: Login-time Check for Pending Files
  954.      ===========================================
  955.  
  956.           Not all BBS software packages  create a DOOR.SYS immediately upon
  957.      a User logging into your  BBS.  For those that do  NOT create DOOR.SYS
  958.      at login-time, this program is of little use, but please keep reading;
  959.      it might still serve you well!
  960.  
  961.           When your BBS  executes its login batch file  (right after a user
  962.      successfully logs  into your BBS),  you can run  DMCHECK.  To  see the
  963.      arguments required and DMCHECK's return-code values, just run  DMCHECK
  964.      with no arguments at all.
  965.  
  966.           When you run DMCHECK in  your login batch file, it makes  a quick
  967.      scan of the DataMail Files database to see if the current User has one
  968.      or more  files waiting to  be downloaded.   If so, DMCHECK  exits with
  969.      return-code  of 1.   You can then  force an execution  of the DataMail
  970.      door via:
  971.  
  972.           DMCHECK DOOR.SYS
  973.           IF ERRORLEVEL == 1 CALL D:\DATAMAIL\DMx.BAT
  974.           .....
  975.  
  976.           Basically, this forces Users  to run DataMail if they  have files
  977.      waiting  for them.  This helps to  get those files off your drive much
  978.      faster.
  979.  
  980.           If your BBS does NOT create DOOR.SYS at login time, you can still
  981.      use DMCHECK  in all of  your other  door batch files.   Basically,  no
  982.      matter what door  the User runs,  you can place  DMCHECK in all  those
  983.      batch files  (before or after  the door supposed  to be run  from that
  984.      batch file).  In  that event, no matter what  door the User runs,  you
  985.      can force  the User to download  his files from DataMail  and get them
  986.      off of your disk.
  987.  
  988.           In other words, say you run the TradeWars door.  Inside the batch
  989.      file  that gets your TradeWars program running, insert the above lines
  990.      (the ones that  run DMCHECK and then  test ERRORLEVEL).   Insert those
  991.      lines either before you run the TradeWars program or after; it doesn't
  992.      matter. By placing the  above lines in your TradeWars batch  file, you
  993.      can force your Caller to check for any files in DataMail whenever they
  994.      run  TradeWars.   Do the same  for all  your door batch  files, and no
  995.      matter what door  the Caller runs, you can force  them to run DataMail
  996.      and download their file(s).
  997.                                     DataMail
  998.      Sysop's Manual               Version 1.1                       Page 17
  999.      ======================================================================
  1000.  
  1001.  
  1002.      DMREPORT: Cross-Referenced Statistics
  1003.      =====================================
  1004.  
  1005.           DMREPORT  provides you  with a  way to  peek inside  the DataMail
  1006.      databases  and see  what is  there.   The reports  are sent  to stdout
  1007.      (i.e., your  terminal), so you  can redirect the  output to a  file or
  1008.      your printer via the DOS ">" redirection operator.
  1009.  
  1010.           DMREPORT provides  3  categories  of  reports:  Users,  Files,  &
  1011.      Groups.    There  are  a  total  of  7  reports  available,  numbered,
  1012.      coincidentally, from 1 though 7.  To get a particular  report, you run
  1013.      "DMREPORT y"  where "y" is the  report number you want.   DMREPORT can
  1014.      handle multiple reports from a single execution.  If  you want reports
  1015.      2, 3, and 4, you  can execute "DMREPORT 2  3 4" and all three  reports
  1016.      will be  produced.   Because  of this  ability  (and because  you  can
  1017.      redirect  the output to your  printer), DMREPORT issues  a final form-
  1018.      feed character  at the  end  of each  report.   This  will cause  your
  1019.      printer to advance to the top  of the next page after each  report has
  1020.      been produced.
  1021.  
  1022.           Report 1  simply generates  a list of  known BBS Users  and their
  1023.      security level.   I admit this is of little use  on a daily basis, but
  1024.      it does come in handy after you rebuild DM010000.KEY/.DAT to make sure
  1025.      that these files were properly created.
  1026.  
  1027.           Reports  2,  3,  and 4  give  you  information  about each  file,
  1028.      uploader, and receiver.  They come in handy when you need to know what
  1029.      files DataMail knows  about, who has uploaded what, or  who is waiting
  1030.      to download what.
  1031.  
  1032.           Reports 5, 6, and 7  deal with Groups, Hosts, and Members.   This
  1033.      lets you readily  see what Groups you  have defined, what  Groups each
  1034.      User is a Host of, and what groups each User is a  member of.  If your
  1035.      Group Host or  Members are complaining  that things  don't seem to  be
  1036.      working  correctly, these reports may help you isolate any problems in
  1037.      your set-up.
  1038.  
  1039.  
  1040.      DMUTIMSG: UTI Message Builder/Invocation
  1041.      ========================================
  1042.  
  1043.           DMUTIMSG  serves  two  purposes.    The  first  is  to  take  the
  1044.      "shorthand" messages created by either DATAMAIL or DMUSRBLD and expand
  1045.      them  into  full-blown  text  messages,  suitable  for  processing  by
  1046.      UTIIMPRT.EXE.  The second is to spawn UTIIMPRT.EXE which will actually
  1047.      import the desired messages into your BBS messages base.
  1048.  
  1049.           DMUTIMSG is run with either 2 or 3 arguments:
  1050.  
  1051.                DMUTIMSG DMESSAGE.x n
  1052.           -or-
  1053.                DMUTIMSG DMESSAGE.x n Y
  1054.                                     DataMail
  1055.      Page 18                      Version 1.1                Sysop's Manual
  1056.      ======================================================================
  1057.  
  1058.  
  1059.           The "x" is  the Node  number which  created DMESSAGE.x.   If  you
  1060.      follow my recommendations in  setting up DataMail, Node 1  will create
  1061.      DMESSAGE.1,  Node 2 will create DMESSAGE.2, etc.  DMUSRBLD will create
  1062.      either  DMESSAGE.0, or  DMESSAGE.x if you  supply a Node  number as an
  1063.      argument to DMUSRBLD.  If you are running a multi-node BBS, you should
  1064.      only process the  DMESSAGE.x file  which is associated  with the  Node
  1065.      number that  you are running DMUTIMSG  from.  If you  are running from
  1066.      the  DOS command-line,  you can  execute DMUTIMSG  for  any DMESSAGE.x
  1067.      file, as long as there is no one currently logged onto those Nodes.
  1068.  
  1069.           The "n" in  the above  files varies from  BBS to  BBS.  Some  BBS
  1070.      software keeps all messages in a  single directory, and has a bunch of
  1071.      files named something like "MSG01.KEY/.DAT, MSG02.KEY/.DAT", etc., for
  1072.      as many message bases as your have.  If this describes your BBS (e.g.,
  1073.      SpitFire),  then "n"  is the message  base number into  which you want
  1074.      your  DataMail messages  imported.   For  example,  if you  want  your
  1075.      messages imported into message base 14, then "n" is 14.
  1076.  
  1077.           For  other  BBS  software  packages  (e.g.,  PCBoard), "n"  is  a
  1078.      directory  name.   BBSes  like this  have  one subdirectory  for every
  1079.      message  base, and  each subdirectory  has files named  something like
  1080.      "M1.TXT, M2.TXT,  ... M9999999.TXT", etc.   For this type of  BBS, "n"
  1081.      will   likely  be  the  SUBDIRECTORY  name.    For  example,  if  your
  1082.      subdirectories are called C:\BBSMSGS\MSGS01,  C:\BBSMSGS\MSGS02, etc.,
  1083.      for  message bases 1  & 2, then  "n" will be  C:\BBSMSGS\MSGS02 if you
  1084.      want DataMail messages imported into message base 2.
  1085.  
  1086.           The easiest way to  find out which you should be  using is to run
  1087.      your UTILIST program.  Run it as "UTILIST TEMP.LST".  Then take a look
  1088.      at  the contents  of TEMP.LST.   Each message  base your  BBS supports
  1089.      requires three  lines of information in TEMP.LST.  Look at lines 1, 4,
  1090.      7,  10, etc.   If you  see a  simple number  on these lines,  then you
  1091.      should  run DMUTIMSG  where "n"  is a  number.   If you  see directory
  1092.      names, then you should run DMUTIMSG where "n" is a directory name.
  1093.  
  1094.           The  3rd  argument is  optional.    If  present, it  must  be  an
  1095.      uppercase "Y" (no quotes,  just the letter Y).  If it is not a "Y", it
  1096.      is  simply ignored.  The purpose of  this optional parameter is to let
  1097.      you mark your DataMail messages as e-mail messages (i.e., they will be
  1098.      echoed on  a national network).  The messages will be echoed onto that
  1099.      network if you are connected to it, and if the  conference number into
  1100.      which  you import DataMail messages is configured as an e-mail message
  1101.      base.  This might come in handy if someone on a network calls your BBS
  1102.      long  distance and uploads  a file  to 1 or  more people.   When those
  1103.      receivers  download  the file,  DataMail will  send  a message  to the
  1104.      Uploader  to   let  him/her  know  that   each  receiver  successfully
  1105.      downloaded the file.  By marking the DataMail messages as e-mail,  the
  1106.      receipt-acknowledgement messages will  be echoed onto  the network  so
  1107.      your  long-distance caller will know  when (if) his  uploaded file was
  1108.      received.
  1109.                                     DataMail
  1110.      Sysop's Manual               Version 1.1                       Page 19
  1111.      ======================================================================
  1112.  
  1113.  
  1114.           All  messages  imported  into  your  BBS  message base  have  the
  1115.      following information somewhere within them:
  1116.  
  1117.           -    Uploader's Name
  1118.           -    Receiver's Name
  1119.           -    Filename
  1120.           -    "Status" or "Function" performed
  1121.           -    Date and Time "Function" was performed
  1122.  
  1123.           Some   messages   (like   Upload/Overlay)   contain   the  2-line
  1124.      description  of the file.  In most  cases, the message is addressed TO
  1125.      and  FROM the  Uploader/Downloader  or Downloader/Uploader,  depending
  1126.      upon  which "way" the  message is directed.   In other  cases (like an
  1127.      expired file which  is deleted), the message is  FROM "DATAMAIL".  All
  1128.      messages are sent as Receiver Only ("Private").
  1129.  
  1130.  
  1131.      Local Mode from Your BBS
  1132.      ========================
  1133.  
  1134.           If you, as  the Sysop, wish to use DataMail  "locally" to send or
  1135.      receive files, and you are logged into your BBS, all you have to do is
  1136.      run  your  DataMail  door  just  as  any   User  would.    No  special
  1137.      considerations need be  given as long as you are  logged into your BBS
  1138.      and running DataMail from there.
  1139.  
  1140.           When you do, all rules  that apply to a Remote User apply  to you
  1141.      (DataMail considers you to be just another User).  There are, however,
  1142.      a couple of differences.
  1143.  
  1144.           First,  you will  see two  additional options  that Remote  Users
  1145.      don't  see and can't execute.   These are a shell  to the DMCONFIG and
  1146.      DMUSRBLD.   You may  run either  of these  programs directly  from the
  1147.      DataMail door if you wish to.
  1148.  
  1149.           Secondly,   your  "uploads"   and  "downloads"   work  a   little
  1150.      differently.  The difference is that the file transfer batch files are
  1151.      not spawned.  You  are asked for the Drive:\Path\Filename  to "upload"
  1152.      or "download",  and a low-level  DOS copy  is performed to  copy files
  1153.      into and  out  of the  DataMail  Files  directory.   Checks  for  file
  1154.      existence and  file size still apply; you  cannot "upload" a file that
  1155.      is larger than  your allowed size.  If  you need to "upload"  a really
  1156.      big file, use the  Shell to DMCONFIG option and set yourself up with a
  1157.      Security  Level that  allows bigger  files.   When you  return to  the
  1158.      DataMail door, you will then be allowed to "upload" bigger files.
  1159.  
  1160.  
  1161.      Local Mode from DOS
  1162.      ===================
  1163.  
  1164.           Please review the  above section for  operational differences  of
  1165.      the DataMail door when running in local mode.
  1166.                                     DataMail
  1167.      Page 20                      Version 1.1                Sysop's Manual
  1168.      ======================================================================
  1169.  
  1170.  
  1171.           There  is a special requirement for running DataMail from the DOS
  1172.      command-line.   DataMail requires a  DOOR.SYS file at all  times.  The
  1173.      simplest way of establishing a "fake" DOOR.SYS is to run DataMail once
  1174.      from your  BBS (see the previous  section) and then exit  back to your
  1175.      BBS.   From your BBS, "shell to DOS".  While in DOS, copy the DOOR.SYS
  1176.      file  to  your  D:\DATAMAIL  directory  and  call  it  something  like
  1177.      LOCAL.SYS or NODE0.SYS.  Return to your BBS (by typing EXIT on the DOS
  1178.      command line), and then, finally, logoff of your BBS.
  1179.  
  1180.           Now, go to D:\DATAMAIL,  crank-up your text editor, and  create a
  1181.      batch file called LOCAL.BAT  or perhaps DM0.BAT.  Place  the following
  1182.      in that batch file:
  1183.  
  1184.                D:
  1185.                CD \DATAMAIL
  1186.                DATAMAIL LOCAL.SYS (or whatever you called DOOR.SYS)
  1187.                IF EXIST DMESSAGE.0 DMUTIMSG DMESSAGE.0 n
  1188.  
  1189.           The "n"  in the last line  above is explained in  the section for
  1190.      DMUTIMSG.  One more change and then you are done.  While you have your
  1191.      text editor running, edit LOCAL.SYS (or whatever you called it).  Look
  1192.      at line 4.   If you just  created LOCAL.SYS by logging onto  your Node
  1193.      number 1 of your BBS, this line will have a 1 in it.  If your ran from
  1194.      Node number  2, this line  will have  a 2 in  it, etc.   Whatever that
  1195.      number is, change it to 0 and then save LOCAL.SYS.
  1196.  
  1197.           That's all.   Now, you should be able to simply type DM0 from the
  1198.      DOS command-line and DataMail should run just fine for you.  Note that
  1199.      you do not have to  use Node number 0 for this purpose.   You can just
  1200.      as easily use Node number 999 or some other ridiculously large number.
  1201.      Whatever Node number you choose, make sure that LOCAL.SYS (line 4) and
  1202.      DMESSAGE.x have the same Node number.
  1203.  
  1204.  
  1205.      Sponsorship Advertising
  1206.      =======================
  1207.  
  1208.           There  is a new phenomenon  taking hold across  the country where
  1209.      BBS Callers pay to purchase software for the Sysop.  I am happy to see
  1210.      this  new   "Share  and   share  alike"   attitude  spreading.     One
  1211.      consideration though, and that  is that most Callers who  buy software
  1212.      for  their Sysop expect to  have their name  prominently displayed for
  1213.      all other Callers to  see.  Who can blame them?  If a Caller wishes to
  1214.      buy  software for use by the Sysop  and other Callers, it is certainly
  1215.      not an outrageous demand that they get the credit for it.
  1216.  
  1217.           DataMail offers  a feature whereby you, the  Sysop, can establish
  1218.      one or more "Advertisement" files, one of which will be displayed each
  1219.      time the DataMail  door is started.   What you put  in those files  is
  1220.      your business -  the intent was  to let you  say something like  "This
  1221.      Door  is brought to you  by Joe Caller", but  you can use this feature
  1222.      for displaying a newsletter, fancy ANSI graphics, or whatever else you
  1223.      wish the Callers to see when they run DataMail.
  1224.                                     DataMail
  1225.      Sysop's Manual               Version 1.1                       Page 21
  1226.      ======================================================================
  1227.  
  1228.  
  1229.           To use  this feature, you need to create one or more files called
  1230.      "DMAD", "DMAD.G", "DMADssss", and/or "DMADssss.G".  The "ssss" portion
  1231.      of the  last two filenames is  supposed to be replaced  by the various
  1232.      numerical security levels you have available.
  1233.  
  1234.           To  illustrate how this works,  suppose you logon  as "Sysop" (or
  1235.      whatever name  you usually use) and  you have a security  level of 99.
  1236.      When you run DataMail, it looks for the DMAD*.* files in this order:
  1237.  
  1238.           If you have ANSI graphics (color) turned on, DataMail looks for
  1239.                DMAD99.G  If it cannot find this file, then it looks for
  1240.                DMAD99    If it cannot find this file, then it looks for
  1241.                DMAD.G    If it cannot find this file, then it looks for
  1242.                DMAD      If it cannot find this file, nothing is displayed.
  1243.  
  1244.           If you do not have ANSI graphics turned on, DataMail looks for
  1245.                DMAD99    If it cannot find this file, then it looks for
  1246.                DMAD      If it cannot find this file, nothing is displayed.
  1247.  
  1248.           In  brief, DataMail gives first priority to finding a file by the
  1249.      name of DMADssss.*, and within that priority, it tries to use the ANSI
  1250.      graphics file if it exists and if you had ANSI graphics turned on when
  1251.      you first started DataMail.
  1252.  
  1253.           So, for example,  if there's a "catch-all" file  that you want to
  1254.      make  sure everyone  sees,  call it  DMAD  (and/or DMAD.G  for  ANSI).
  1255.      However, if certain security  levels should see a different  file than
  1256.      most  other   Callers,   set-up  the   appropriate  DMADssss   (and/or
  1257.      DMADssss.G).
  1258.  
  1259.           On the other hand, perhaps there are security levels (like yours)
  1260.      that you don't want to have such a file displayed.  In this case, just
  1261.      make sure  that DMAD  and DMAD.G  do not exist.   Set-up  DMADssss and
  1262.      DMADssss.G for  all  your security  levels,  except for  the  security
  1263.      levels that you do not want to see the display.
  1264.  
  1265.           What  goes in those DMAD*.* files?  Basically, anything you want.
  1266.      There  are  only two  reserved characters  that  cause the  display to
  1267.      behave  differently  than  simply copying  the  file  to  the Caller's
  1268.      screen.   These two characters are  Ctrl-P and Ctrl-Z.   These are not
  1269.      normally considered  "typing" characters, and do  not naturally appear
  1270.      in ANSI graphics files.  The purposes of these two characters are:
  1271.  
  1272.           -    Ctrl-P  is used as a "Pause" character.  When encountered in
  1273.                your DMAD*.* files, the process of displaying the file comes
  1274.                to a  halt and waits for  the Caller to press  "Enter".  The
  1275.                Ctrl-P  character   itself  is  not  transmitted   -  it  is
  1276.                completely  removed from the display.  If you like to set-up
  1277.                ANSI  displays   that   use  "Sprite   Graphics"   ("moving"
  1278.                characters) or happen to be several  screens in length, then
  1279.                you  might want  to  imbed a  Ctrl-P character  at strategic
  1280.                points in order to let the Caller view what is on the screen
  1281.                before it gets erased with more information.
  1282.                                     DataMail
  1283.      Page 22                      Version 1.1                Sysop's Manual
  1284.      ======================================================================
  1285.  
  1286.  
  1287.           -    Ctrl-Z is  taken  to be  the  End-of-File character.    This
  1288.                character  normally appears  at the end  of every  DOS ASCII
  1289.                file, and  when DataMail encounters it,  the display process
  1290.                is terminated.
  1291.  
  1292.           Note that, if  a DMAD*.* is found (according to  the above rules)
  1293.      and  displayed, there is an  automatic halt built-in  to DataMail upon
  1294.      reaching the end of the file.  Do not imbed a Ctrl-P character  at the
  1295.      end of your  file!  Doing so will force the Caller to press enter once
  1296.      (to respond to the Ctrl-P), and then once more (to respond to the end-
  1297.      of-file condition).  The final pause  is built-in so that your display
  1298.      file doesn't just "flash"  by the Caller without them having  a chance
  1299.      to view it.
  1300.  
  1301.           Note  also  that DataMail  will not  prompt  the Caller  to press
  1302.      "Enter" when  it pauses.  Doing  so could mess-up a  really great ANSI
  1303.      graphics file,  so I chose to  leave out any automatic  prompting.  If
  1304.      you feel  a prompt is  needed, just add  one yourself in  your DMAD*.*
  1305.      files (just before  any Ctrl-P character,  and again as the  very last
  1306.      thing in your file).
  1307.  
  1308.           Hopefully, this feature will tilt the  scales for you if there is
  1309.      a Caller who  is considering  purchasing DataMail  for you,  but is  a
  1310.      little hesitant because he/she  won't get any public credit  for doing
  1311.      so.  The DMAD*.*  files will let you give credit where it is due!  Oh,
  1312.      by the way...  if you don't  want this feature, just don't define  any
  1313.      DMAD*.*  files -  if  they aren't  available,  there are  no  start-up
  1314.      pauses, no delays.  The Callers go straight into DataMail.
  1315.  
  1316.  
  1317.      Registration
  1318.      ============
  1319.  
  1320.           As noted earlier, you cannot buy DataMail; you purchase a license
  1321.      in  perpetuity  to use  it.   A  licensing  fee is  required  for each
  1322.      operational  set of  DataMail files  you use,  regardless of  how many
  1323.      computers and/or disks are involved.  If you run a multi-node BBS, but
  1324.      only have one  set of  operational DataMail files,  you only need  one
  1325.      license.
  1326.  
  1327.           Licenses  are issued for the life of  the BBS Sysop in whose name
  1328.      it  is  issued.    It  is  non-revokable,  but  likewise  it  is  non-
  1329.      transferable (you cannot sell, trade, or give away your license).  The
  1330.      current licensing  fee  for  DataMail is  $20.00  (subject  to  change
  1331.      without advance notice),  payable in  U.S. funds only.   Students  are
  1332.      given a  discount for good grades.   License fees for  students are as
  1333.      follows:
  1334.  
  1335.                     GPA = 95 or higher (A):  $8.00
  1336.                     GPA = 90 or higher (B): $10.00
  1337.                     GPA = 85 or higher    : $12.50
  1338.                     GPA = 80 or higher (C): $15.00
  1339.                                     DataMail
  1340.      Sysop's Manual               Version 1.1                       Page 23
  1341.      ======================================================================
  1342.  
  1343.  
  1344.           To qualify for  this discount, you must  enclose a photo copy  of
  1345.      your last 2 report cards/grade marks.  All GP's for both sets of marks
  1346.      will be added together and divided by the number of marks.  The result
  1347.      (the average) will be the  level you qualify for.   Incomplete courses
  1348.      will be counted as GP = 0.  Discounted licenses for DataMail will have
  1349.      a  registration identifier in the  name of the  Student; no customized
  1350.      registration   identifier  is   available  for   discounted  licenses.
  1351.      However, if you wish to obtain a customized registration identifier at
  1352.      a  later date, you may  pay the difference  between your original cost
  1353.      (as detailed  above) and  the current price  for DataMail in  its non-
  1354.      discounted  form.   The copies of  marks you  submit must  be the most
  1355.      recent markings you have received.  Sending a copy of markings from 18
  1356.      months ago qualifies you for 0 discount.  Any obvious tampering (in my
  1357.      judgement)  qualifies you for 0 discount.   If you wish to ensure your
  1358.      marks are judged as legitimate, have the copies notarized.
  1359.  
  1360.           Site-licenses  are  NOT  available.    Each  operational  set  of
  1361.      DataMail files requires a $20.00 licensing fee.
  1362.  
  1363.           Your registration identifier may be obtained either by calling my
  1364.      BBS and downloading it,  by diskette via U.S. Mail  (additional charge
  1365.      for diskette and postage), or by having me call your BBS and uploading
  1366.      it  (pre-payment of  LD  fee &  pre-established  account on  your  BBS
  1367.      required).   This identifier will  display on your screen  in place of
  1368.      the "Not Registered" message.   You may  have this customized to  your
  1369.      liking; anything  from your name, to  your BBS's name, to  "The Man in
  1370.      the Moon".
  1371.  
  1372.  
  1373.      Conversion to Other BBS Software
  1374.      ================================
  1375.  
  1376.           If you currently run a BBS  that supports DOOR.SYS, but for which
  1377.      there is not yet a  DMUSRBLD.EXE program (or you are getting  ready to
  1378.      switch to such software from your  current BBS and want to be able  to
  1379.      run DataMail for that software also), you may be able to obtain a free
  1380.      license for  DataMail.  I offer a free registration to the first Sysop
  1381.      of a  not-yet-supported BBS  package who  is willing  to assist me  in
  1382.      porting DataMail to it.
  1383.  
  1384.           Basically   what  is  involved,  is  that  I  need  to  create  a
  1385.      DMUSRBLD.EXE program for your BBS software.  To do this, I will need a
  1386.      significant  amount of information from you about that software.  Such
  1387.      items will include the file layouts of the BBS  Master File, how a new
  1388.      door is "added" or "defined" to that  BBS, etc.  You will also have to
  1389.      locate  a  UTI package  for your  BBS package  if  you want  to import
  1390.      DataMail messages into your BBS message bases.
  1391.                                     DataMail
  1392.      Page 24                      Version 1.1                Sysop's Manual
  1393.      ======================================================================
  1394.  
  1395.  
  1396.           Please write  for  details.   Include  your mailing  address  and
  1397.      daytime,  evening,  and  weekend  phone  numbers.    Creating  a   new
  1398.      DMUSRBLD.EXE  program will  be  the major  hurdle,  and once  that  is
  1399.      completed, you may easily run  DataMail on your new BBS.   However, in
  1400.      the interest of  providing proper documentation,  I will also  require
  1401.      that  you review and correct  my installation procedures  for your BBS
  1402.      software.  In some extreme  cases, I will require that you  provide me
  1403.      with  a  sample BBS  Master  File with  dummy  Users  who exhibit  all
  1404.      possible combinations of security levels and status-flags.
  1405.  
  1406.           The  actual work  you  will  have  to  perform  is  research  and
  1407.      documentation  correction,  along  with  verification   that  the  new
  1408.      DMUSRBLD.EXE  program is working properly for  your BBS.  My work will
  1409.      be  to write the code for your  new DMUSRBLD.EXE and provide drafts of
  1410.      documentation for  your review.   Once successfully  ported, you  will
  1411.      receive  a free license for DataMail.   If you have already registered
  1412.      DataMail for your "old" BBS, I will refund the licensing fee you paid.
  1413.      Note, however,  that refunds of  shipping fees or  Long-Distance phone
  1414.      calls are NOT given; just the basic licensing fee for DataMail.
  1415.                            DataMail Registration Form
  1416.                            (one per license, please)
  1417.  
  1418.      Name _________________________________________________________________
  1419.  
  1420.      Mailing Address ______________________________________________________
  1421.                      ______________________________________________________
  1422.                      ______________________________________________________
  1423.                      ______________________________________________________
  1424.  
  1425.      [ ] I am registering DataMail version 1 at $20.00
  1426.      [ ] I am a student, applying for my registration at $__________.  I
  1427.          have enclosed a copy of my 2 most recent markings, and according
  1428.          to the Sysop's Manual, Registration Section, I calculate my GPA
  1429.          to be _______.  If this is not correct, I authorize you to return
  1430.          my registration fee immediately.
  1431.  
  1432.  
  1433.      I would like  my Registration  Identifier to read  (not available  for
  1434.      Student discounts  - whatever you place  in the "Name"  field above is
  1435.      what your Registration Identifier will be):
  1436.  
  1437.      ______________________________________________________________________
  1438.         (maximum 60 characters, including spaces, and no double-quotes)
  1439.  
  1440.  
  1441.      [ ] I will call your BBS (214-398-3112) and download my Registration
  1442.          Identifier.  I understand that I must call NOW and establish an
  1443.          account.  I will allow 14 days for my registration fee to reach
  1444.          you, and I will call after that time to download my Identifier.
  1445.      [ ] Please send me my Registration Identifier on 3.5" 720K diskette
  1446.          (add $7.00 for U.S. destinations, $10.00 for international).
  1447.      [ ] Please send me my Registration Identifier on 5.25" 360K diskette
  1448.          (add $5.00 for U.S. destinations, $8.00 for international).
  1449.      [ ] Please call my BBS and upload my Registration Identifier (add
  1450.          $4.00 for Texas numbers, $3.00 for continental U.S., $6.00 for
  1451.          Alaska/Hawaii/Puerto Rico/Canada, $12.00 all others).  I have
  1452.          already established an account for you on my BBS (use back of
  1453.          this form to explain LogonID, Password, & procedures to log into
  1454.          your BBS).  I understand that you will attempt to call until my
  1455.          BBS answers, but if I have not provided you with the correct
  1456.          information and you cannot logon as directed, you will not call
  1457.          again, but will immediately refund my registration fee, less
  1458.          the additional money for the pre-paid long-distance charge.
  1459.  
  1460.  
  1461.  
  1462.                  Please remit all monies in U.S. funds only to:
  1463.  
  1464.                                 Richard K. Naff
  1465.                                2023 Shortal Drive
  1466.                              Dallas, TX 75217-1834
  1467.                                      U.S.A.
  1468.                             DataMail Problem Report
  1469.  
  1470.      Please  use this form to report operational problems with DataMail.  I
  1471.      will respond to messages left on  my BBS (214-398-3112), and to  those
  1472.      left in RIME (Node ->DFWPGMR)  SpitFire Software, SpitFire Sysops, and
  1473.      Sysops  conferences,  but the  following  information  is required  no
  1474.      matter if you mail this form or leave electronic mail for me:
  1475.  
  1476.      DataMail Version Number: _____________________________________________
  1477.      CPU Type (8088, 8086, 80186, 80286, 80386, 80486): ___________________
  1478.      ISA/EISA/PS2 Databus (if you don't know, assume ISA): ________________
  1479.      BBS brand and version number: ________________________________________
  1480.      Is your BBS software registered and paid for? ________________________
  1481.      Drive:\Path\ to your BBS Master File: ________________________________
  1482.      Drive:\Path\ to your UTI programs: ___________________________________
  1483.      Drive:\Path\ to your DataMail programs: ______________________________
  1484.      Drive:\Path\ to your DataMail uploads: _______________________________
  1485.      DOS version number & manufacturer: ___________________________________
  1486.      DesqView / Windows  / LAN  version, number of  windows active,  window
  1487.      configuration info, etc.: ____________________________________________
  1488.                                ____________________________________________
  1489.                                ____________________________________________
  1490.      TSR's & Device Drivers loaded: _______________________________________
  1491.                                     _______________________________________
  1492.                                     _______________________________________
  1493.      Front-end program (if any) and parameters: ___________________________
  1494.                                                 ___________________________
  1495.      Is your DTE/DCE speed locked? ________________________________________
  1496.      If so, do you have RTS/CTS handshaking active? _______________________
  1497.      Parameters to SHARE.EXE in your CONFIG.SYS: __________________________
  1498.      Number of FILES & BUFFERS in CONFIG.SYS: _____________________________
  1499.  
  1500.      State exact nature of problem.  Include all symptoms, such as when the
  1501.      problem  occurs & when  it doesn't, number  of nodes  active & online,
  1502.      etc.  If related to file transfers, list your file transfer batch file
  1503.      for me please, and DMXFERS.TXT.  Use additonal sheets if required.  If
  1504.      possible,  provide a sample screen-capture of events leading up to the
  1505.      problem, and the contents of DMLOG.x:
  1506.  
  1507.      ______________________________________________________________________
  1508.  
  1509.      ______________________________________________________________________
  1510.  
  1511.      ______________________________________________________________________
  1512.  
  1513.      ______________________________________________________________________
  1514.  
  1515.      ______________________________________________________________________
  1516.  
  1517.      ______________________________________________________________________
  1518.  
  1519.      ______________________________________________________________________
  1520.  
  1521.                      Please send the above information to:
  1522.                                 Richard K. Naff
  1523.                                2023 Shortal Drive
  1524.                              Dallas, TX 75217-1834
  1525.